home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / nm400qrg.zip / NM400QRG.DOC next >
Text File  |  1991-01-02  |  60KB  |  1,723 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                 GT POWER - 16.00
  16.            Copyright (c) 1987, 1988, 1989, 1990: by P & M Software Co.
  17.                             All rights are reserved.
  18.  
  19.  
  20.  
  21.                                GT Netmail System
  22.  
  23.                                 QUICK REFERENCE
  24.                                      GUIDE
  25.  
  26.                                   NETMAIL 400
  27.  
  28.                              by Warren Leadbeatter
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                              P & M Software Company
  37.                              3104 E. Camelback Rd. 
  38.                              #503
  39.                              Phoenix, AZ  85016    
  40.                              U.S.A
  41.  
  42.                              Voice Phone: (602) 285-9914
  43.                              Modem Phone: (602) 285-1146
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                     - 1 -
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                Table of Contents
  65.                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  66.  
  67.  
  68.      The Mail Bagger
  69.      ~~~~~~~~~~~~~~~
  70.         Mail Bagger Command Line Options . . . . . . . . . . . . . . . .  4
  71.  
  72.  
  73.      The Mail Distributor
  74.      ~~~~~~~~~~~~~~~~~~~~
  75.         Mail Distribution Command Line Options . . . . . . . . . . . . .  6
  76.  
  77.  
  78.      The Mail Driver
  79.      ~~~~~~~~~~~~~~~
  80.         The Subdirectories . . . . . . . . . . . . . . . . . . . . . . .  8
  81.  
  82.         Command Line usage . . . . . . . . . . . . . . . . . . . . . . .  8
  83.  
  84.         DOS Shell  . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  85.  
  86.         Passwords  . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  87.  
  88.         Command Line Options . . . . . . . . . . . . . . . . . . . . . . 10
  89.  
  90.         A NOTE about G_UNPAK . . . . . . . . . . . . . . . . . . . . . . 10
  91.  
  92.         Command Line Options for CRASH! Mail . . . . . . . . . . . . . . 15
  93.  
  94.         The /F WOOF FRONT END Option . . . . . . . . . . . . . . . . . . 15
  95.  
  96.         Example HOST.BAT for FRONT END . . . . . . . . . . . . . . . . . 16
  97.  
  98.         WOOF FRONT END Error Levels  . . . . . . . . . . . . . . . . . . 17
  99.  
  100.      The ROUTING.BBS
  101.      ~~~~~~~~~~~~~~~
  102.         Structure  . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
  103.  
  104.         Phone Number Transforms  . . . . . . . . . . . . . . . . . . . . 18
  105.  
  106.         Modem Dial Modifiers . . . . . . . . . . . . . . . . . . . . . . 19
  107.  
  108.         CALL WINDOWS . . . . . . . . . . . . . . . . . . . . . . . . . . 19
  109.  
  110.         Call windows modifiers . . . . . . . . . . . . . . . . . . . . . 19
  111.  
  112.         Example ROUTING.BBS  . . . . . . . . . . . . . . . . . . . . . . 21
  113.  
  114.  
  115.  
  116.                                     - 2 -
  117.  
  118.  
  119.  
  120.  
  121.      Q BAGS and the Q Converter
  122.      ~~~~~~~~~~~~~~~~~~~~~~~~~~
  123.         Quick BAGS Description . . . . . . . . . . . . . . . . . . . . . 22
  124.         
  125.         Q Convert (QCVT105)  . . . . . . . . . . . . . . . . . . . . . . 22
  126.  
  127.         Selective generation and/or inclusion of Q Bags  . . . . . . . . 23
  128.  
  129.         BAG CONSOLIDATION Flags  . . . . . . . . . . . . . . . . . . . . 23
  130.  
  131.  
  132.      DOT Commands
  133.      ~~~~~~~~~~~~
  134.         NetMail DOT Commands . . . . . . . . . . . . . . . . . . . . . . 24
  135.  
  136.  
  137.      Your Notes
  138.      ~~~~~~~~~~
  139.  
  140.         Start  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.                                     - 3 -
  176.  
  177.  
  178.      MBAGGER Command Line Options
  179.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  180.  
  181.  
  182.           /CF ..... Suppress  all  .FR  requests   encountered  during  the
  183.                     bagging  run.
  184.  
  185.           /CD ..... Suppress  all  .DX  requests   encountered  during  the
  186.                     bagging run.
  187.  
  188.           /CA ..... Suppress both .FR and .DX requests.  As if you had both
  189.                     /CF and /CD on the command line at the same time.
  190.  
  191.           /Dn ..... This option specifies the number of days  you  wish  to
  192.                     retain  old  bags  of  Echomail.  These  bags  must  be 
  193.                     retained for awhile so  that  they  are  available  for 
  194.                     newcomers  and  for people who miss a day or two of the 
  195.                     conference.  The system defaults to 14  days,  I  would 
  196.                     not advise a shorter period,  but this mechanism can be 
  197.                     used to lengthen the period.  I use /D31 on  my  system 
  198.                     at  001/003,  but I have no crunch on disk space at the 
  199.                     moment.  
  200.  
  201.           /G ...... Do not Bag Mail. Instead only analyze existing mailbags
  202.                     to see if any consolidations can be performed.
  203.                     Used in G_UNPAK.BAT. See MDRIVER /G
  204.  
  205.           /Knn .... The  'nn'  should  be be a  unique number between 1 and
  206.                     65535.   It  is  used  with  the .CY command to encrypt
  207.                     messages on your system.
  208.                     Please note, you should  _NOT_ use te same /k number on
  209.                     the MBAGGER and MDIST command lines.   Keep this number
  210.                     SECRET.
  211.  
  212.           /L ...... Causes  MBAGGER  to  use  the   NAME=  entry  from  the
  213.                     SCHEDULE.BBS  file  in the  ORIGIN  line of the message
  214.                     without converting it to UPPERCASE.
  215.  
  216.           /N ...... This  option  enables  MBAGGER to be run more than once
  217.                     per day.  On the first run of MBAGGER,  this option  is 
  218.                     not used,  but all subsequent runs on that day MUST use 
  219.                     the /N command line switch. /N stands for NEXT RUN.
  220.  
  221.           /NL ..... Suppress  the new  G bag  logging from MBAGGER.  If not
  222.                     present,  MBAGGER will  cause entries  to be written to
  223.                     GBAG.LOG to document the creation/update of G bags.
  224.  
  225.           /NP ..... This  option causes the  MBAGGER  program  to  skip the
  226.                     pruning of echomail from  \MAILOUT  and is quite useful
  227.                     in speeding the operation of the program.  The echomail
  228.                     need not be pruned more than once a day.
  229.  
  230.  
  231.  
  232.  
  233.  
  234.                                     - 4 -
  235.  
  236.  
  237.      MBAGGER Command Line Options Cont'd
  238.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  239.  
  240.           /OC ..... This option allows the  MBAGGER program to be used with
  241.                     GT POWER 14.03 and before.  The native mode of  MBAGGER
  242.                     will be the GT POWER 15.50 mode.
  243.  
  244.           /Q ...... When you specify the  /Q option  on the command line of
  245.                     MBAG411, Q  bags  will be generated for all conferences
  246.                     that are sponsored by your system, in  addition  to the
  247.                     regular E bags.  You may examine the results to see the
  248.                     efficiency (or lack thereof) of the new procedure.
  249.  
  250.           /QO ..... The  /QO  option will cause  MBAG411 to generate Q bags
  251.                     ONLY. If you require E bags later, the QCVT program can
  252.                     be used to create E bags from your Q bags.
  253.  
  254.             Note:  If  you  are  handling  Q  bags  then the  MBAG  program
  255.                    *should* be run with the /Q option AT ALL TIMES. Several
  256.                    people have reported  problems due to the fact that they
  257.                    have used the Q option occasionally, or not at all (and
  258.                    have used QCVT to generate Q bags).  If  you  process  Q
  259.                    bags, then use the /Q option on ALL executions of  MBAG.
  260.                    If you run QCVT, you might consider using  /QO for speed
  261.                    sake.
  262.  
  263.           *  See the Q BAGS and QCVT SECTION for more info Q bags
  264.  
  265.           /R ...... This option is used to specify an  alternative  routing
  266.                     file.  If  not specified,  the program will process the 
  267.                     standard ROUTING.BBS, but with this option, any routing 
  268.                     file may be named for input.  For example: 
  269.  
  270.                          /R:foo.bar
  271.  
  272.                     In this case,  the routing instructions would  be  read 
  273.                     from the file 'foo.bar'.  
  274.  
  275.           /VG .... Produce a verbose listing of the GCONSOL file on screen.
  276.                    WITHOUT  the  /VG  option, the  GCONSOL file will not be
  277.                    listed.
  278.  
  279.           /X ...... Bag  mail in  a normal  fashion, but  skip any echomail
  280.                     conference which is sponsored by the local sysop.  This
  281.                     prevents  problems with  multiple baggings  on the same
  282.                     day by echomail  sponsors. The  echomail sponsor  would
  283.                     need at least 1 run per day without this option.
  284.  
  285.   /ZX /ZI /ZS ..... are now permissible command line arguments for MBAG and
  286.                     MDIST.  This gives MBAG and MDIST support for the newer
  287.                     version of PKZIP, which no long use the 1..4 numbers in
  288.                     conjunction with choosing compression methods.
  289.  
  290.  
  291.  
  292.  
  293.                                     - 5 -
  294.  
  295.  
  296.  
  297.      MDIST Command Line Options
  298.      ~~~~~~~~~~~~~~~~~~~~~~~~~~
  299.  
  300.           /G ...... Do   not   Distribute   mail.   Instead   examine   all
  301.                     consolidated bags that have been received  addressed to
  302.                     the local node and break them down into their component
  303.                     parts. Used in G_UNPACK.BAT.  SEE MDRIVER /G
  304.  
  305.           /Knn .... The 'nn' should be a unique number between 1 and 65535.
  306.                     It is used with the .CY  command to decrypt messages to
  307.                     your system. Please note, you should _NOT_ use the same
  308.                     /K number on the MDIST and MBAGGER command lines.  Keep
  309.                     the  number on  your  MBAGGER  line  secret, _but_ tell
  310.                     those, who wish to send encrypted messages  to you, the
  311.                     number you have  selected  for use on your  MDIST  line
  312.                     (otherwise incoming messages may not be decrypted).
  313.  
  314.           /NA ..... No  Remote  File  Attach.  This command  causes any .RA
  315.                     received  from  a  remote  system  to  be  discarded. A
  316.                     message will be returned to the  sender explaining that
  317.                     the .RA was not authorized.
  318.  
  319.           /NR ..... Causes  the  response to the  .GL  command to exclude a
  320.                     full list of available  echomail  conferences.  Instead
  321.                     producing  a  report  of  the  current  status  of  the
  322.                     requestor's conferences only.
  323.  
  324.           /NL ..... Causes  MDIST  to  suppress  keeping the new G bag log.
  325.                     This  new  log is now  produced  by  default,  and this
  326.                     switch can be used to suppress it.  If the log is kept,
  327.                     a record of each G bag processed through  MDIST and its
  328.                     contents will be kept in a file called  GBAG.LOG.  This
  329.                     file  will  grow indefinitely, it is up to the sysop to
  330.                     periodically archive it.  MDIST will build a new one if
  331.                     an existing GBAG.LOG file is not found.
  332.  
  333.           /OC ..... This option allows the MDIST program to be used with GT
  334.                     POWER 14.03 and before.  The native mode of  MDIST will
  335.                     be the GT POWER 15.00 mode.
  336.  
  337.           /R ...... This allows the user to specify the use of an alternate
  338.                     routing  file instead of the standard ROUTING.BBS file.
  339.                     For example:
  340.  
  341.                                 MDIST  /r:hay.stk
  342.  
  343.                     In this example,  MDIST would read the required routing
  344.                     instructions  from the  file 'hay.stk', instead  of the
  345.                     ROUTING.BBS file.
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.                                     - 6 -
  353.  
  354.  
  355.  
  356.  
  357.      MDIST Command Line Options Cont'd
  358.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  359.  
  360.  
  361.           /SA ..... Save  both  B  and  G  bags  prior  to  unpacking   and
  362.                     distributing.  Same  as  above  for  the  /SB  and  /SG
  363.                     options.
  364.  
  365.           /SB ..... Save B bags prior to unpacking and distributing  to the
  366.                     message base.  The bags are saved in MAILARC.ARC, which
  367.                     will be created in the \MAILIN directory.  The sysop is
  368.                     responsible  for  pruning bags  from  this  archive  as
  369.                     required.
  370.  
  371.           /SG ..... Save  G bags prior to unpacking and distributing.  Same
  372.                     as above for the /SB option.
  373.  
  374.           /V ...... This  option can  be used when G bag logging is enabled
  375.                     (which is the default).   The  /V option causes verbose
  376.                     logging of G bags before they are unpacked.  MDIST will
  377.                     invoke  PKARC  or PKZIP, as required, with the V option
  378.                     and  append the  output  to  the  GBAG.LOG  file.  Thus
  379.                     providing  a complete record of the files  contained in
  380.                     the G bag.
  381.  
  382.           /VG .... Produce a verbose listing of the GCONSOL file on screen.
  383.                    WITHOUT  the  /VG  option, the  GCONSOL file will not be
  384.                    listed.
  385.  
  386.   /ZX /ZI /ZS ..... This gives MBAG and MDIST support for the newer version
  387.                     of PKZIP, which  no  longer  use  the  1..4  numbers in
  388.                     conjunction with choosing compression methods.  This is
  389.                     used to select the storage  method to  be used with the
  390.                     /SB, /SG and /SA options listed above. Unpacking of ZIP
  391.                     format is handled automatically, the MDIST program will
  392.                     auto-sense ZIP vs ARC format bags.
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.                                    - 7 -
  412.  
  413.  
  414.      MDRIVER
  415.      ~~~~~~~
  416.  
  417.      NOTE!
  418.      ~~~~~                                                                .
  419.         This  program  must  now  be  installed  to use.   The installation
  420.         procedure is quite simple,  the  first  time  the program  is  run,
  421.         it will prompt you for the required information:  name,  S/N and GT
  422.         key.    The  program  should  not  be  renamed   until   successful
  423.         installation has been done.   Also,  you should have the program in
  424.         the  GTPATH  directory  and it should be made the default directory
  425.         when the installation is done.
  426.  
  427.      Sub Directories
  428.      ~~~~~~~~~~~~~~~
  429.           \MAILWORK ........... Usually empty.  Temporary work area.
  430.           \MAILOUT ............ Outgoing mail bags.
  431.           \MAILOUT\FILEOUT .... Outgoing  files for use  with "File Attach"
  432.                                 and "File Request".
  433.           \MAILOUT\DEADLTR .... Stale mail.  Put  here when  can't deliver.
  434.           \MAILIN ............. Incoming mail bags.
  435.           \MAILIN\FILEIN ...... Incoming  files  sent via  "File Attach" or
  436.                                 as a result of a "File Request".
  437.           \MAILIN\PROBLEMS .... Incoming  mail  bags  that  for some reason
  438.                                 couldn't be unpacked (eg.Damaged Bags). Can
  439.                                 be either B, E or G bags.  Moved  here  for
  440.                                 manual inspection and disposal.
  441.      
  442.      Command Line Usage
  443.      ~~~~~~~~~~~~~~~~~~
  444.  
  445.         There are several command line parameters for the MDRIVER  program.
  446.         They are as follows:
  447.  
  448.            The netmail CRC Identification number.
  449.            The session start time.
  450.            The session end time.
  451.            The latest start time for the session.
  452.  
  453.         These  are  the  basic  parameters  and  must be specified and must
  454.         be specified in the order listed.  For example:
  455.  
  456.                     MDRIVER  XXXX-YYYY  4   5  0455
  457.  
  458.         The above example would run the Netmail from 4 am to 5 am.  And the
  459.         latest start time would be 4:55 am.
  460.  
  461.                     MDRIVER  AAAA-BBBB  4:30   5:25  5:20
  462.  
  463.         The  above  example would run the  Netmail from 4:30 am to 5:25 am.
  464.         And the latest start time would be 5:20 am.
  465.  
  466.         In the above  examples,  the XXXX-YYYY  and  AAAA-BBBB are the CRC
  467.         Identification  Number   pairs   obtained   from   the  GT Netmail
  468.         Coordinator.
  469.  
  470.                                     - 8 -
  471.  
  472.  
  473.      DOS SHELL
  474.      ~~~~~~~~~
  475.  
  476.         DOS Shell and  Quick Shell.   These are new options available only
  477.         while MDRIVER is waiting for an incoming call.
  478.  
  479.         a) Press 'S' to obtain the  DOS  Shell.   The  routing  file   and
  480.            nodelist are reloaded upon return to MDRIVER.
  481.  
  482.         b) Press 'Q' to obtain the  Quick  Shell.   No files are  reloaded
  483.            upon return to MDRIVER.
  484.  
  485.         c) A menu will be put on screen to remind you of these options.
  486.  
  487.      PASSWORDS
  488.      ~~~~~~~~
  489.         A new file,  GTNETPWD.BBS,  must be created with a text  editor to
  490.         hold the passwords.   Each password will be used to identify 1 and
  491.         only 1 connection.      For example, if 079/000 calls 004/000, and
  492.         Bryan and Jim agree to the password "lumpy".       Here is how the
  493.         GTNETPWD.BBS file would look on each system.
  494.  
  495.         GTNETPWD.BBS on 079/000               GTNETPWD.BBS on 004/000
  496.         -----------------------               -----------------------
  497.         004/000,lumpy                         001/003,noise
  498.         001/003,random                        079/000,lumpy
  499.  
  500.         Please notice:
  501.  
  502.         The password for the 079/000 to 004/000 connection is 'lumpy'  and
  503.         that  it  is  privately  agreed  upon  between  the  two   systems
  504.         themselves.  No other person need be aware of the chosen password.
  505.         Both systems  must have the same password listed for each other.
  506.  
  507.         The password for 079/000 to  001/003  is  *not*  the same  as  the
  508.         password  for  004/000 to 001/003.   That is,  these passwords are
  509.         always selected independently for each unique connection.
  510.  
  511.         If you  list a password for a system, then that system must supply
  512.         that password.   If the calling system is unprepared to supply the
  513.         required password, then it will not connect.
  514.  
  515.         This method should provide a very high degree of security.
  516.  
  517.         The passwords can be composed of any legal ASCII character, except
  518.         for CR/LF/EOF (EOF = Ctrl-Z).   But I  would  recommend  that  you
  519.         stick to more normal characters.      Passwords are limited to ten
  520.         (10) chars.
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.                                     - 9 -
  530.  
  531.  
  532.      MDRIVER Command Line Options
  533.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  534.  
  535.  
  536.           /A ...... This new switch allows the operator to specify the ring
  537.                     upon which the phone should be answered.   By  default,
  538.                     MDRIVER will answer on the 2nd ring. This seems to work
  539.                     somewhat more reliably than the 1st ring answering.
  540.  
  541.           /Bnn .... The  'nn'  is the  number  of times  you wish to try to
  542.                     connect to a remote  city  through  PC  Pursuit at 2400
  543.                     baud (if available), before dropping down to 1200. This
  544.                     parameter only  affects the dialing  through PC Pursuit
  545.                     to a remote city (i.e. the Telenet "C D" command).
  546.  
  547.           /CA%3 ... See CRASH! MAIL Section
  548.  
  549.           /CC ..... See CRASH! MAIL Section
  550.  
  551.           /E ...... Allows the user to specify the maximum number of errors
  552.                     to allow during a netmail transfer before aborting  the 
  553.                     session.  Very  useful  to  keep from wasting time on a 
  554.                     bad connection.  Values below 3  are  not  recommended.  
  555.                     For example: 
  556.  
  557.                          /E3
  558.  
  559.                     This  would  allow 3 errors to occur before the session 
  560.                     would terminate.  
  561.  
  562.           /F ...... See FRONT END Section
  563.  
  564.           /G ...... MDRIVER xxxx-yyyy ... /G ...
  565.  
  566.                     This command would cause the  MDRIVER  program to SHELL
  567.                     to a special batch file at  the end  of any call during
  568.                     which the local system has received a consolidated bag.
  569.                     The name of the special  batch file is  G_UNPAK.BAT.  A
  570.                     sample follows:
  571.  
  572.                            MDIST    /R:r0100.bbs    /G
  573.                            MBAGGER  /R:routing.cr1  /G
  574.  
  575.                     This  would  cause any consolidated bag received during
  576.                     a   session   to  be   immediately   broken   down  and
  577.                     re-consolidated in the indicated manner (by the routing
  578.                     and bag consolidation instructions).
  579.  
  580.  
  581.          NOTE about G_UNPAK
  582.          ~~~~~~~~~~~~~~~~~~
  583.          The /G command line option for MDRIVER has been redone.  No longer
  584.          will MDRIVER invoke the G_UNPAK.BAT file.       There simply isn't
  585.          enough room in memory for it to run reliably. See next page also.
  586.  
  587.  
  588.                                     - 10 -
  589.  
  590.  
  591.      MDRIVER Command Line Options Cont'd
  592.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  593.  
  594.          Instead, MDRIVER will exit with errorlevel  255  whenever a  G bag
  595.          unpack is triggered via the /G command line option. The sysop must
  596.          arrange his batch file to account for  this  and  restart  MDRIVER
  597.          after the unpack operation is complete.
  598.  
  599.           /H ...... Allows  for  the  specification  of  a  custom   "Human
  600.                     Notice".   Instead  of  the  default  notice,  you  can 
  601.                     customize the notice you system uses  to  notify  human 
  602.                     callers  of  the  netmail  processing in progress.  For 
  603.                     example: 
  604.  
  605.                          /H:foo.bar
  606.  
  607.                     The file 'foo.bar' will be displayed to human callers.  
  608.  
  609.           /In...... Use  BIMODEM  to do transfers.  DO NOT  use PC Pursuit.
  610.                     Use like this:
  611.  
  612.               /I         Use BiModem.  Not on PC Pursuit. No max baud rate.
  613.               /I2400     Use BiModem.  Not on PC Pursuit.  At or below 2400
  614.                          baud.
  615.  
  616.           /IPn..... Use  BIMODEM  to do transfers. Yes, use on  PC Pursuit!
  617.                     Use like this:
  618.  
  619.               /IP        Use BiModem.  Enable PC Pursuit. No max baud rate.
  620.               /IP4800    Use BiModem.  Enable PC Pursuit.  At or below 4800
  621.                          baud.
  622.           
  623.           /Lnn .... This option would cause  MDRIVER  to try each node only
  624.                     'nn' times before  removing  it from  the calling queue
  625.                     for the session.  For example:
  626.  
  627.                          /L3
  628.  
  629.                     This would cause the  MDRIVER  to try each node 3 times
  630.                     then giving up.  The nodes will be dialed in the normal
  631.                     rotation, of course --this does not affect the order in
  632.                     which they are called.
  633.  
  634.           /Mn ..... Limits outgoing calls so  that they will not "fallback"
  635.                     below this lower limit. The 'n' is the lowest baud rate
  636.                     that may be used in a "fallback" situation.
  637.  
  638.                     For example:
  639.  
  640.                                /M2400
  641.  
  642.                     would limit "fallbacks" so that they would not go below
  643.                     2400 baud.
  644.  
  645.  
  646.  
  647.                                     - 11 -
  648.  
  649.  
  650.      MDRIVER Command Line Options Cont'd
  651.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  652.  
  653.           /NC ..... This option would cause  MDRIVER to take the crash call
  654.                     for long enough to get the caller's id, then disconnect
  655.                     Effectively this is an option to say: NO CRASH CALLS AT
  656.                     THIS TIME.  But it will update the  GTNET.LOG  file and
  657.                     show you the ID of the calling system.
  658.  
  659.           /NOW .... This  can be placed on the command line where the start
  660.                     time is usually given.  This insures that  MDRIVER will
  661.                     begin immediately, no matter what the  current time is.
  662.                     Of course, care must still be  taken  with  the  ending
  663.                     time,   but  the  latest  start  time  is  now  ignored
  664.                     (although it must still be stated).  For example:
  665.  
  666.                New style:
  667.  
  668.                 mdriv043 xxxx-yyyy /now 2459 2459 /cc /q /r:routing.cr2 /zc
  669.  
  670.                Old style:
  671.  
  672.                 mdriv043 xxxx-yyyy 0100 2459 2459 /cc /q /r:routing.cr2 /zc
  673.  
  674.           /NL ..... Do not answer incoming calls.  Assumes sysop is present
  675.                     and  will not continue normal operation after a RING is
  676.                     detected, until sysop hits the <CR> key.
  677.  
  678.           /NR ..... Do  not  answer incoming calls.  Assumes sysop is _not_
  679.                     present  and  _will_  continue normal operation after a
  680.                     30  second  pause.  No keystroke is required to restart
  681.                     operation.
  682.  
  683.                     These options are useful if you wish to make a outgoing
  684.                     crash mail  call from a  phone  normally used for voice
  685.                     operations. Please note that these options should _not_
  686.                     be used on  your  regular  data line, since  they  will
  687.                     interfere with the normal handling of incoming calls.
  688.  
  689.           /OW ..... This  option  turns  the CALL WINDOWS, described below,
  690.                     into a full scheduling mechanism.
  691.                     All inbounds/outbounds  will be  auto-generated to make
  692.                     the MDRIVER call the designated systems at the required
  693.                     time (all other calls will be automatically suppressed)
  694.                     The OW stands for   "Outbound Windows".   Since the /OW
  695.                     option  generates  inbound  and   outbound   statements
  696.                     automatically,  the  node  range  option  of  the  CALL
  697.                     WINDOWS  should  not  be  used.  The program can become
  698.                     easily confused.
  699.          **********
  700.          * WARNING: DO NOT use the option unless you are using CALL WINDOWS
  701.          ********** Extra outbound calls will be placed if this  command is
  702.                     used in the absence of CALL WINDOWS.
  703.  
  704.  
  705.  
  706.                                     - 12 -
  707.  
  708.  
  709.      MDRIVER Command Line Options Cont'd
  710.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  711.  
  712.  
  713.           /P ...... Allow calls to be made to  900  series nodes. Normally,
  714.                     no call would be made to 900 series systems.
  715.  
  716.           /Q:x .... This  is  an  old  option  with  a  new  twist.  The /Q
  717.                     continues to  mean  that the  MDRIVER  will  quit after
  718.                     placing all calls. But now you may specify a particular
  719.                     node  that  is  to  be  called.  The 'x' has the format
  720.                      'net-node'.  For example:
  721.              /Q:009-000
  722.                     This  would force a call to 009/000, then exit from the
  723.                     program.
  724.              /Q009000
  725.                     This  is  the  same  as  above.  The punctuation is for
  726.                     readability only, and may be omitted by the user.
  727.              /Q
  728.                     This  would  allow   MDRIVER   to  follow  the  routing
  729.                     instructions, and quit after all calls have completed.
  730.  
  731.           /QI ..... The  purpose  of  this command line option is the cause
  732.                     MDRIVER  to  quit  after  a  specific  incoming call is
  733.                     received.
  734.  
  735.                     For example:   /QI:009-000
  736.  
  737.                     This would cause MDRIVER to quit to DOS after receiving
  738.                     a call from 009/000.   During  this run,  no  out-going
  739.                     calls will be made.
  740.  
  741.           /R        Allows for the use of alternate routing files,  instead
  742.                     of the standard ROUTING.BBS file.  
  743.  
  744.                          /R:some.rte
  745.  
  746.                     The MDRIVER will get routing instructions from the file 
  747.                     'some.rte', instead of ROUTING.BBS.  
  748.  
  749.           /RL ..... MDRIVER has a new command line option, /RL. This option
  750.                     must be used to enable the new result  code  logging of
  751.                     BUSY and NO CARRIER. The default will now be to not log
  752.                     these items,  and  /RL  will turn the  logging of these
  753.                     items on.
  754.  
  755.           /Tm:n ... Allows the user to specify the allowed maximum times in
  756.                     seconds to be connected to  PC Pursuit  and to still be
  757.                     allowed to redial on a BUSY.  In other words, when  the
  758.                     program is about to redial after a BUSY,  it checks the
  759.                     current connect time against this limit,  if the  limit
  760.                     has been exceeded, then it  will  cease  redialing  and
  761.                     disconnect from PC Pursuit.
  762.  
  763.  
  764.  
  765.                                     - 13 -
  766.  
  767.  
  768.      MDRIVER Command Line Options Cont'd
  769.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  770.  
  771.  
  772.           /ZC ..... Enables the use of the Zmodem protocol through DSZ.COM.
  773.  
  774.           /ZE ..... Enables the use of the Zmodem protocol through DSZ.EXE.
  775.  
  776.                     If  you  are  enabling  either  DSZ,  then  the version
  777.                     selected, either EXE or COM,  must be  available in the
  778.                     GT POWER home directory.  For example, if you have:
  779.  
  780.                     set GTPATH=C:\GT
  781.  
  782.                     Then DSZ must be located in the C:\GT directory.  It is
  783.                     not invoked via a "shell" or a batch file, but  for the
  784.                     sake  of  security and speed, it is  executed  directly
  785.                     from MDRIVER as a "child" process.  This  allows a very
  786.                     close cooperation  between  the two programs.  But the
  787.                     result is that the  normal  ZM??.BAT batch files cannot
  788.                     be used, nor is the regular  DOS PATH  searched to find
  789.                     DSZ.
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.                                       - 14 -
  825.  
  826.  
  827.  
  828.      Command Line Options for MDRIVER to handle CRASH! Mail:
  829.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  830.  
  831.           /CC ..... Make outgoing CRASH! Mail calls.
  832.  
  833.           /CA%3 ... Answer incoming CRASH ! Mail call.  This should only be
  834.                     used in the  GTCRASH.BAT  file,  which is automatically
  835.                     invoked by the  GT POWER  host when an  incoming CRASH!
  836.                     Mail call is received.  This option will only be usable
  837.                     when GT POWER 14.03 is released.
  838.  
  839.                     The "Crash Answer" command line switch must be followed
  840.                     by "%3", so that the  GT POWER  Host  can pass the baud
  841.                     rate to the MDRIVER program. This option should only be
  842.                     used within the GTCRASH.BAT batch file.
  843.  
  844.                     After an incoming CRASH! Mail call is finished, MDRIVER
  845.                     will   automatically  release  control  and  allow  the
  846.                     reloading of the GT POWER Host.
  847.  
  848.                     An example of a GTCRASH.BAT file is shown below:
  849.  
  850.                            c:
  851.                            cd \gt
  852.                            mdriv033 9999-9999 /CA%3 /ZE
  853.                            mdist
  854.  
  855.  
  856.         NOTE:  To enable CRASH! Mail, the NODELIST must be updated to
  857.                reflect which systems are "crashable". This is done by
  858.                placing an '*' before the system name.
  859.  
  860.                The DOOR.EXE program must be available for GTCRASH.BAT 
  861.                to work properly.
  862.  
  863.  
  864.  
  865.  
  866.  
  867.      THE 'WOOF' FRONT END
  868.      ~~~~~~~~~~~~~~~~~~~~
  869.  
  870.           /F ..... The /F command line option for MDRIVER  has  been added.
  871.                    This option allows MDRIVER to act as a frontend  for  GT
  872.                    POWER. The advantage of this feature is that time can be
  873.                    saved when receiving netmail or crashmail calls, i.e. no
  874.                    wait for loading MDRIVER!  The  procedure  for utilizing
  875.                    this feature is somewhat complex.   Please  refer to the
  876.                    batch file included on the following page as an example:
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.                                     - 15 -
  884.  
  885.  
  886.  
  887.        HOST.BAT
  888.        --------
  889.           rem
  890.           rem  Sample batch file for using the WOOF Frontend
  891.           rem
  892.           c:
  893.           cd \gt
  894.           set GTPATH=c:\gt
  895.           :FRONT
  896.           rem
  897.           rem  Note: a netmail session kicks in at 24:00 via errorlevel 4
  898.           rem        as setup in the SCHEDULE.BBS file.
  899.           rem
  900.           mdriv048 1234-5678 /now 2459 2459 /D10 /Ow /Zc /A1 /F
  901.           if errorlevel 254 goto BBSLOC        . Local logon
  902.           if errorlevel 192 goto BBS192        . DCE baud = 19200
  903.           if errorlevel 96  goto BBS96         .    ''    = 9600
  904.           if errorlevel 24  goto BBS24         .    ''    = 2400
  905.           if errorlevel 12  goto BBS12         .    ''    = 1200
  906.           if errorlevel 4   netmail            . Netmail scheduled event
  907.           if errorlevel 3   goto BBS3          . DCE baud = 300
  908.           if errorlevel 1   reboot             . ERROR: reboot computer
  909.           goto end                             . Exit from HOST.BAT
  910.           :BBS192
  911.           gt1550 *1234-5678 /T10 /MN /S /Q /V:E /L7 /F:19200:1
  912.           if errorlevel 254 goto FRONT         . Normal return to WOOF Frontend
  913.           if errorlevel 4   netmail            . Netmail scheduled event
  914.           if errorlevel 1   reboot             . ERROR: reboot computer
  915.           goto end                             . Exit from HOST.BAT
  916.           :BBS96
  917.           gt1550 *1234-5678 /T10 /MN /S /Q /V:E /L7 /F:9600:1
  918.           if errorlevel 254 goto FRONT
  919.           if errorlevel 4   netmail
  920.           if errorlevel 1   reboot
  921.           goto end
  922.           :BBS24
  923.           gt1550 *1234-5678 /T10 /MN /S /Q /V:E /L7 /F:2400:1
  924.           if errorlevel 254 goto FRONT
  925.           if errorlevel 4   netmail
  926.           if errorlevel 1   reboot
  927.           goto end
  928.           :BBS12
  929.           gt1550 *1234-5678 /T10 /MN /S /Q /V:E /L7 /F:1200:1
  930.           if errorlevel 254 goto FRONT
  931.           if errorlevel 4   netmail
  932.           if errorlevel 1   reboot
  933.           goto end
  934.           :BBS3
  935.           gt1550 *1234-5678 /T10 /MN /S /Q /V:E /L7 /F:1200:1
  936.           if errorlevel 254 goto FRONT
  937.           if errorlevel 4   netmail
  938.           if errorlevel 1   reboot
  939.           goto end
  940.           :BBSLOC
  941.           gt1550 *1234-5678 /T10 /MN /S /Q /V:E /L7 /F:LOCAL:1
  942.           if errorlevel 254 goto FRONT
  943.           if errorlevel 4   netmail
  944.           if errorlevel 1   reboot
  945.           :end
  946.           c:
  947.           cd \gt
  948.                                     - 16 -
  949.  
  950.  
  951.      THE 'Woof' FRONT END (cont'd)
  952.      ~~~~~~~~~~~~~~~~~~~~
  953.  
  954.           Notice the extensive usage of errorlevels.       The usage of the
  955.           "WOOF Frontend" requires that the SCHEDULE.BBS use nothing except
  956.           errorlevel triggered events.  Of the type "QUIT n", where 'n'  is
  957.           the indicated errorlevel.    There are a few reserved errorlevels
  958.           though, that must not be used for anything else:
  959.  
  960.           Errorlevel        Meaning
  961.           ----------        -------
  962.                0            Exit from the batch file.
  963.                1            Error.  The system should either reboot or
  964.                             exit from the batch file.
  965.                3            Frontend has taken a call at a DCE baud rate
  966.                             of 300.  Invoke the BBS to handle at the proper
  967.                             rate.
  968.               12            Same as 3, but DCE baud rate = 1200.
  969.               24            Same as 3, but DCE baud rate = 2400.
  970.               48            Same as 3, but DCE baud rate = 4800.
  971.               96            Same as 3, but DCE baud rate = 9600.
  972.              192            Same as 3, but DCE baud rate = 19200.
  973.              254            Local logon to the BBS.
  974.              255            /G bag unpack.
  975.  
  976.           The frontend will handle all  incoming  calls: netmail, crashmail
  977.           and BBS callers.
  978.  
  979.  
  980.      FIDO CRASH MAIL RUNS
  981.      ~~~~~~~~~~~~~~~~~~~~
  982.           MDRIVER will now recognize a string of "q.q." to be a  Fido  type
  983.           crashmail run.    This  is  intended  to be  used  with the  Woof
  984.           Frontend,  if the "q.q.q." string is received,  then the frontend
  985.           will quit with an errorlevel as follows to indicate the  DCE baud
  986.           rate:
  987.  
  988.                         DCE         ERROR
  989.                         BAUD        LEVEL
  990.                         ====        =====
  991.                          300 ....... 200
  992.                         1200 ....... 201
  993.                         2400 ....... 202
  994.                         4800 ....... 203
  995.                         9600 ....... 204
  996.                        19200 ....... 205
  997.                        38400 ....... 206
  998.  
  999.           The  batch  file  for  your  Woof  frontend  should  trap   these
  1000.           errorlevels and take an appropriate action.  If you are running a
  1001.           Fido mailer, then invoke that  mailer.   If not,  then you should
  1002.           probably run a  DROPDTR  type program, or  perhaps invoke the host
  1003.           mode at the proper baud rate,  assuming  that  a  human  caller is
  1004.           online.
  1005.  
  1006.  
  1007.                                     - 17 -
  1008.  
  1009.  
  1010.      ROUTING.BBS
  1011.      ~~~~~~~~~~~
  1012.  
  1013.           The netmail programs now support file inclusion.  That is you can
  1014.           break your routing file down and build them back.
  1015.  
  1016.           For example:
  1017.  
  1018.              ;
  1019.              ;   MAIN NETMAIL ROUTING FILE FOR 001/033
  1020.              ;
  1021.              $ PURSUIT.RTE
  1022.              ;
  1023.              $ OUTBOUND.RTE
  1024.              ;
  1025.              $ WINDOWS.RTE
  1026.              ;
  1027.              $ ROUTE.RTE
  1028.              $ ECHO.033
  1029.              END
  1030.              ;
  1031.              $ DISTRIB.RTE
  1032.              ;
  1033.              ECHOMAIL HOURS 0100-2459
  1034.  
  1035.           Each  line  that  begins  with  a '$'  names another  file to  be
  1036.           included into the current ROUTING.BBS. This makes it very easy to
  1037.           track each functional section of the routing file. File inclusion
  1038.           is completely optional.
  1039.  
  1040.      PHONE NO TRANSFORMS.
  1041.      ~~~~~~~~~~~~~~~~~~~~
  1042.           An additional section for the ROUTING.BBS file.  This  section is
  1043.           intended to make it easier for  sysops  outside of  the  USA  and
  1044.           Canada to setup their dialing strings.
  1045.  
  1046.           Here is the basic format:
  1047.  
  1048.             PHONE NO TRANSFORMS
  1049.                 61-2 -> 02
  1050.                 61-5 -> 065
  1051.             END
  1052.  
  1053.            Up to 50 transforms can be specified.  In the example above, the
  1054.            first  entry  shows  that phone  numbers  from the nodelist that
  1055.            begin with "61-2" will have that string replaced by "02".    For
  1056.            example, 61-2-671-5538 would become 02-671-5538.
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.                                     - 18 -
  1067.  
  1068.  
  1069.      MODEM PRE-DIAL String
  1070.      ~~~~~~~~~~~~~~~~~~~~
  1071.            The Modem Dial Pre-String is configurable.  Normally this string
  1072.            defaults  to  something like 'ATDT'.    It  may  be  selectively
  1073.            overridden by placing the new pre-string on a CALL WINDOW entry.
  1074.            The  override  becomes  global,  however,  and  is  not directly
  1075.            associated with the CALL WINDOW - it is just a convenient way to
  1076.            associate a net/node with a particular pre-string.
  1077.  
  1078.              For example:
  1079.  
  1080.                    009/000,2435-2450  'ATX3DT'
  1081.  
  1082.      CALL WINDOW MODIFIERS
  1083.      ~~~~~~~~~~~~~~~~~~~~~
  1084.            /IN, /CC and /? are now CALL WINDOW modifiers.  These parameters
  1085.            are used within the CALL WINDOWS section of the routing file. As
  1086.            follows:
  1087.  
  1088.           /IN ..... Specifies an INbound window.       If an INbound window
  1089.                     exists for a node, then it must call within that   time
  1090.                     frame, otherwise the call will be rejected.
  1091.  
  1092.           /CC ..... Specifies a window that is to use   CRASH Call methods.
  1093.                     In other words, the destination system is  probably not
  1094.                     in netmail during the specified time frame.
  1095.  
  1096.           /? ...... Specifies a conditional window.   A conditional  window
  1097.                     is a window that will be executed if the      specified
  1098.                     system  has not be previously connected   with  on  the
  1099.                     current date.  To enable the /? option to work, MDRIVER
  1100.                     will now keep a new log file, GTNETDAY.LOG.    This log
  1101.                     will be  automatically  restarted  at the  beginning of
  1102.                     each day. It will record each system connected with and
  1103.                     the duration of each connect.         This log does not
  1104.                     accumulate, so  there is no maintenance associated with
  1105.                     it.  It exists for the sole purpose of allowing the /?
  1106.                     option to function.
  1107.  
  1108.           Here are some examples:
  1109.  
  1110.                  CALL WINDOWS
  1111.                      009/000,2435-2450
  1112.                      079/000,2401-2416
  1113.                      001/032,2430-2455
  1114.                      004/005,0145-0200
  1115.                      009/000,0315-0345 /?
  1116.                      031/000,0230-0300 /IN
  1117.                      001/003,0401-0415
  1118.                      001/032,0315-0330 /?
  1119.                      004/005,0330-0345 /?
  1120.                      009/000,0501-0530 /CC /?
  1121.                  END
  1122.  
  1123.  
  1124.  
  1125.                                     - 19 -
  1126.  
  1127.  
  1128.  
  1129.      CALL WINDOWS (cont'd)
  1130.      ~~~~~~~~~~~~~~~~~~~~
  1131.  
  1132.           Please note that the /CC and /? can be used in combination.    It
  1133.           does  not make any sense to use /IN in conjunction with the other
  1134.           two, since it is not used in relationship to outgoing calls.
  1135.  
  1136.           /=n ..... Where the  'n'  is a number  in the range 1.....7. This
  1137.                     option would restrict the associated window  to the day
  1138.                     of the week specified.  Where  1=Sunday, 2=Monday, etc.
  1139.                     More than one '/=' can be given per window.
  1140.  
  1141.                     For example:
  1142.  
  1143.                      009/000,0200-0230 /=1 /=4
  1144.  
  1145.                     This window would be executed on Sunday and Wednesday.
  1146.  
  1147.           /MB ..... This  option  would restrict  the associated window to
  1148.                     being performed only when a (M)ail (B)ag was   waiting
  1149.                     to be delivered.  The mailbag can be either   of the G
  1150.                     or B variety.
  1151.  
  1152.  
  1153.           /NPP .... This option disables PC Pursuit for the call going  out
  1154.                     under the current window.  Normally,     MDRIVER  would
  1155.                     force   PC Pursuit   usage   whenever  possible,   this
  1156.                     modifier allows a temporary suspension of   PC  Pursuit
  1157.                     usage.
  1158.  
  1159.           /EX ..... This option is related to the  /IN  or inbound  option.
  1160.                     With it you can dedicate a CALL WINDOW to the indicated
  1161.                     system.  It can be used for either incoming or  outgoing
  1162.                     calls.  But any CALL WINDOW with this option    becomes
  1163.                     exclusive to the listed system.  For example:
  1164.  
  1165.                     009/000,0200-0215 /EX
  1166.  
  1167.                     This  means that no incoming call from any system other
  1168.                     than 009/000  will be taken during  the 15 minute  span
  1169.                     02:00-02:15.
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.                                     - 20 -
  1185.  
  1186.  
  1187.         EXAMPLE ROUTING.BBS
  1188.         ~~~~~~~~~~~~~~~~~~~
  1189.  
  1190.         PREFIXES  LOCAL (*)  DISTANT (*)
  1191.  
  1192.         PHONE NUMBER TRANSFORMS
  1193.              61-2- -> ,
  1194.              61-65- -> 065
  1195.         END
  1196.  
  1197.         CALL WINDOWS
  1198.              302/000,0340-0415 'ATB1DT'
  1199.              302/023,0440-0515 /IN
  1200.         END
  1201.  
  1202.         INBOUND NODES
  1203.              302/023
  1204.         END
  1205.  
  1206.         OUTBOUND NODES
  1207.              302/000
  1208.         END
  1209.  
  1210.         ROUTING INSTRUCTIONS
  1211.         ;
  1212.         ; instructions for echos
  1213.         ;
  1214.              ACCEPT E00/001 -> 302/000
  1215.              ACCEPT E01/999 $nxnx-nxnx      <--- CRC for echo goes here
  1216.              ACCEPT E99/073 -> 302/000
  1217.              ACCEPT 001-300/000-899 -> 302/000
  1218.              ACCEPT 001-300/900-999 -> 302/000
  1219.         ;
  1220.         ;instructions for netmail
  1221.         ;
  1222.              ACCEPT 302/000
  1223.              ACCEPT 302/001-015 -> 302/000
  1224.              ACCEPT 302/017-022 -> 302/000
  1225.              ACCEPT 302/023
  1226.              ACCEPT 302/024-899 -> 302/000
  1227.              ACCEPT 302/900-999 -> 302/000
  1228.              ACCEPT 303/000-099 -> 302/000
  1229.              ACCEPT 307/000-099 -> 302/000
  1230.              ACCEPT 308/000-099 -> 302/000
  1231.              ACCEPT 310/000-899 -> 302/000
  1232.              ACCEPT 310/900-999 -> 302/000
  1233.              ACCEPT 800-999/000-899 -> 302/000
  1234.              ACCEPT 800-999/900-999 -> 302/000
  1235.         END
  1236.  
  1237.         BAG CONSOLIDATION
  1238.                 302/000,ZQ
  1239.                 302/023,ZQ
  1240.         END
  1241.  
  1242.         MESSAGE DISTRIBUTION
  1243.                E00/001      -> F:\GTECHO\GTSUPPRT    ,  GT_Support
  1244.                E01/999      -> F:\GTECHO\someecho    ,  Some_desc
  1245.                E99/073,1    -> SKIP                  ,  ACS_HAM_RADIO
  1246.         END
  1247.  
  1248.  
  1249.                                     - 21 -
  1250.  
  1251.  
  1252.      Q BAGS and CONVERT (QCVT105)
  1253.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1254.  
  1255.      (Q)uick Bags!
  1256.  
  1257.            (Q)uick Bags are replacements for the old E bags.  You know  the
  1258.            bags that are named like this: E0954001.E00.  Now we will have a
  1259.            replacement  for the E bags, named like the E bags, but with the
  1260.            first character  of  the filename  equal to Q, like this:
  1261.  
  1262.            Q0954001.E00.
  1263.  
  1264.            (Q)uick bags are 20-50% smaller than regular E bags created with
  1265.            PKARC,    and maybe even smaller than ZIPped E bags, since these
  1266.            archivers do not   handle   small files  like messages well.  To
  1267.            create a (Q)uick bag we use our own squeeze program, called NMSQ
  1268.            (which must be placed into your GTPATH directory).     Also, the
  1269.            WORDLIST file must be present.  This  is  a  dictionary of words
  1270.            used in a pre-compression process.
  1271.  
  1272.            The QCVT program is being  made  freely  available to  everyone.
  1273.            It performs three different tasks:
  1274.  
  1275.            1.  Take E bags and generate Q bags from them.  Option /Q.
  1276.            2.  Take Q bags and generate E bags from them.  Option /E.
  1277.            3.  Take Q bags and generate M files (in \MAILWORK).  No option.
  1278.  
  1279.            Here are some command line examples:
  1280.  
  1281.                 QCVT [filespec] [option]
  1282.  
  1283.            If not specified, the filspec will default to \MAILOUT\*.*
  1284.            If not specified, the option will default to #3 above, which
  1285.            breaks down Q bags into their component M files.
  1286.  
  1287.                 QCVT /E
  1288.  
  1289.            Means to search  \MAILOUT for all Q bags and generate E bags, if
  1290.            they do not already exist.
  1291.  
  1292.                 QCVT /Q
  1293.  
  1294.            Means to search \MAILOUT  for all E bags and generate Q bags, if
  1295.            they do not already exist.
  1296.  
  1297.                 QCVT q0955001.e01
  1298.  
  1299.            Take this Q bag  and break it down into  M message files in  the
  1300.            \MAILWORK directory.
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.                                     - 22 -
  1309.  
  1310.  
  1311.      Selective generation of Q Bags
  1312.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1313.  
  1314.            Selective generation of  Q bags is possible by adding a Q to the
  1315.            line  in the   MESSAGE  DISTRIBUTION  section  for the indicated
  1316.            conferences.
  1317.  
  1318.            Like this:
  1319.  
  1320.                   MESSAGE DISTRIBUTION
  1321.                      E01/009,10   -> D:\BETA_ECO , ;GT_Beta_Echo
  1322.                      E01/011,10,Q -> D:\TEST_ECO , ;Q_Test_Echo
  1323.                   END
  1324.  
  1325.            In this example,    E01/009 will have only E  bags generated and
  1326.            E01/011  will  have both Q and E bags generated. Of course, this
  1327.            assumes that no  /Q  is given on the   MBAG  command line.  This
  1328.            syntax is only useful for  conferences that you sponsor.
  1329.  
  1330.  
  1331.      Selective inclusion of Q Bags
  1332.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1333.  
  1334.            Selective inclusion of  Q  bags in  G  bags  may be accomplished
  1335.            by a similar mechanism in the BAG CONSOLIDATION section.
  1336.  
  1337.            Like this:
  1338.  
  1339.                       BAG CONSOLIDATION
  1340.                          001/032,Z
  1341.                             E00/001,955
  1342.                             E01/009,955
  1343.                             E01/010,955
  1344.                          003/000
  1345.                             E01/009,955
  1346.                             E01/010,955
  1347.                          009/000,ZQ
  1348.                             E00/001,955
  1349.                             E00/005,955
  1350.                       END
  1351.  
  1352.            In the above example, nodes 001/032 and 003/000 will  get normal
  1353.            E bags put into their  G  bags,  but node 009/000 will receive Q
  1354.            bags if they are available. If  Q bags are  not  available, then
  1355.            009/000 will receive regular E bags.
  1356.  
  1357.            Flags for node entries.
  1358.  
  1359.            Z ....... Use PKZIP to build G Bags for the indicated node.
  1360.  
  1361.            F ....... Override ';' in Message Distribution. Allows the
  1362.                      indicated node to receive a full .GL report when
  1363.                      requested.
  1364.  
  1365.  
  1366.  
  1367.                                     - 23 -
  1368.  
  1369.  
  1370.      NETMAIL DOT COMMANDS
  1371.      ~~~~~~~~~~~~~~~~~~~~
  1372.  
  1373.  
  1374.           .FA ..... The .FA command will  accept  a  path  other  than  the
  1375.                     \MAILOUT\FILEOUT directory.
  1376.  
  1377.                     For example:
  1378.  
  1379.                     .FA foo.bar
  1380.  
  1381.                     Would pick-up FOO.BAR from the \MAILOUT\FILEOUT
  1382.                     directory.
  1383.  
  1384.                     .FA \lotus\spread.wks
  1385.  
  1386.                     Would pick-up SPREAD.WKS from the \LOTUS directory.
  1387.  
  1388.           .FR ..... Here is an example of a "File Request" command:
  1389.  
  1390.                     .FR nodelist.arc
  1391.  
  1392.                     This   would   cause  the  file  "nodelist.arc"  to  be
  1393.                     requested from the destination system when  the message
  1394.                     containing the ".FR" command is delivered.
  1395.  
  1396.           .DX ..... Here is an example of a "Direct Xpress" command.
  1397.  
  1398.                     .DX
  1399.  
  1400.                     This would cause  the  message which  contains  the .DX
  1401.                     to  be  routed  directly  to  the  addressee's  system,
  1402.                     without any store and forward operation.
  1403.  
  1404.           .CC ..... An  internal  system  command,  used  by  the system to
  1405.                     garble netmail messages. Should not be directly used by
  1406.                     individuals.
  1407.  
  1408.           .CY ..... Encrypt  the  information  on the line following.  This
  1409.                     information will be returned to normal on the receiving
  1410.                     system.
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.                                     - 24 -
  1427.  
  1428.  
  1429.         DOT Commands Cont'd
  1430.         ~~~~~~~~~~~~~~~~~~~
  1431.  
  1432.  
  1433.           .CS ..... Acts like a continuous run of .CY commands. For example
  1434.                     if you wanted to encrypt an entire paragraph or message
  1435.                     Like this:
  1436.  
  1437.                     .CStart
  1438.                     These lines will be encrypted.
  1439.                     This is the second line to be encrypted.
  1440.                     .CStop
  1441.  
  1442.                     The two lines shown between the .CStart and .CStop will
  1443.                     be   encrypted.  The .CS command  works  with  the  .KE
  1444.                     command in the same way that the .CY command does, with
  1445.                     the extra attraction that the .KE command may itself be
  1446.                     encrypted.  Like this:
  1447.  
  1448.                     .CSstart
  1449.                     .KE 8123
  1450.                     All lines between the .CStart and .CStop are encrypted.
  1451.                     This is another line encrypted.
  1452.                     .CStop
  1453.  
  1454.                     This   just  adds  one  more  level  of  protection  to
  1455.                     sensitive data.
  1456.  
  1457.           .EC ..... An  internal  system  command,  used  by  the system to
  1458.                     garble echomail conferences.  Should  not  be  directly
  1459.                     used by individuals.
  1460.  
  1461.           .KE ..... This command affects the encryption process done by .CY
  1462.                     and .CS so  that  it is less likely that outsiders will
  1463.                     be  able  to  unsramble  the  information.  The .KE  is
  1464.                     followed  by a number between 1 and  65535, which  must
  1465.                     match the /K number on the receivers MDIST command line
  1466.                     For example:
  1467.  
  1468.                     If the  receiver  told  you ahead of time that his code
  1469.                     number  was /k8123 on his  MDIST command line, then you
  1470.                     would code this in your message:
  1471.  
  1472.                     .KE 8123
  1473.                     .CY
  1474.                     .CY This is an encrypted message, that can be read by
  1475.                     .CY a system with /k8123 on the MDIST command line.
  1476.                     .CY
  1477.  
  1478.                     Then the receiving system should have:
  1479.  
  1480.                     MDIST  /r:routing.bbs  /k8123
  1481.  
  1482.  
  1483.  
  1484.  
  1485.                                     - 25 -
  1486.  
  1487.  
  1488.         DOT Commands Cont'd
  1489.         ~~~~~~~~~~~~~~~~~~~
  1490.         
  1491.  
  1492.           .GL ..... If this  command  is  placed  in a netmail message to a
  1493.                     system  which  is sending you a G bag, that system will
  1494.                     respond with a report  of  the  current  status  of the
  1495.                     conferences you are receiving  and,  if  authorized,  a
  1496.                     list of conferences available on that remote system.
  1497.  
  1498.                     Example:      .GL
  1499.  
  1500.                     Where  the "." is  located in the first position of the
  1501.                     line.
  1502.  
  1503.           .GM ..... If this  command  is placed  in  a netmail message to a
  1504.                     system which is sending you a G bag, it  will allow you
  1505.                     to add conferences or modify the  day  number  that you
  1506.                     are receiving in a currently received conference.
  1507.  
  1508.                     Example:      .GM e00/001,810
  1509.  
  1510.                     Again,  where  the "." would  be  located  in the first
  1511.                     position of the line.  The  GM  is followed by a single
  1512.                     space and the echo conference number  you  wish to add/
  1513.                     modify, followed by the new or starting day number.
  1514.  
  1515.           .GQ ..... If this command  is  placed  in a  netmail message to a
  1516.                     system which is sending you  a G bag, it will allow you
  1517.                     to drop a conference from the G bag you are receiving.
  1518.  
  1519.                     Example:      .GQ e00/001
  1520.  
  1521.                     As  above,  the  "."  should  be  located  in the first
  1522.                     position of the line.  The  GQ  is followed by a single
  1523.                     space and the echo conference number you wish to remove
  1524.  
  1525.           .MA ..... This command  is  much  like  the  .FA command. It will
  1526.                     also accept full pathname  specification  or default to
  1527.                     the \MAILOUT\FILEOUT directory,  when  no  pathname  is
  1528.                     given.  It  will  take  the  named  file  and  create a
  1529.                     message  to  be  sent  with  the  "cover message".  The
  1530.                     attached  message will be given the same security level
  1531.                     as the "cover message".  One caveat exists, that is the
  1532.                     attached message must be an ASCII text file, the  first
  1533.                     line of which has  the  following:  MSG ATTACH.  If the
  1534.                     message does not contain the  MSG ATTACH  header,  then
  1535.                     the file will not be attached.  This provision is made,
  1536.                     so  that  the sysop  will have control over which ASCII
  1537.                     files are attachable in this manner.  For example:
  1538.  
  1539.                            .MA c:\wp\text.dat
  1540.  
  1541.  
  1542.  
  1543.  
  1544.                                     - 26 -
  1545.  
  1546.  
  1547.         DOT Commands Cont'd
  1548.         ~~~~~~~~~~~~~~~~~~~
  1549.  
  1550.  
  1551.           .RA ..... This is a Remote File  Attach.  The command works  much
  1552.                     like a  FR (File Request) command, except that it works
  1553.                     through normal network  channels, causing the receiving
  1554.                     system to generate a FA for the  requested  file.  Only
  1555.                     files located in the \MAILOUT\FILEOUT  directory can be
  1556.                     obtained in this manner, as pathnames are not supported
  1557.                     with this command.  For example:
  1558.  
  1559.                            .RA foobar.dat
  1560.  
  1561.                     Would generate the following on the host system:
  1562.  
  1563.                            .FA foobar.dat
  1564.  
  1565.                     And automatically send the  message  and  attached file
  1566.                     back to the original requestor.
  1567.  
  1568.           .RR ..... This  is the  Return  Receipt  Request.  The  receiving
  1569.                     system will respond with a message  confirming  receipt
  1570.                     of the message containing the  .RR command.  The Return
  1571.                     Receipt should be in the following form:
  1572.  
  1573.                     ~CS
  1574.  
  1575.                     The following message was received at: 009/000
  1576.                     ==============================================
  1577.                         Msg No  :  2021
  1578.                         Date    :  3-13-89
  1579.                         Time    :  20:50
  1580.                         Sender  :  Paul Meiners
  1581.                         Topic   :  NOTHING IMPORTANT
  1582.  
  1583.                     Prepared By The MDIST Program:  3-13-89 22:10
  1584.  
  1585.                     ~CS
  1586.  
  1587.                     .ORIGIN: 009/000 - the Programmer's Workshop -West!
  1588.  
  1589.                     Note  the  usage  of .CS  encryption  to   help  insure
  1590.                     accuracy.  The  message  number  is  the  number of the
  1591.                     original  message  on  the sending system (the one with
  1592.                     the .RR command).
  1593.  
  1594.           .RV ..... An internal  system  command,  used  by  the  system to
  1595.                     provide  'return receipts '  associated  with  the  .RR
  1596.                     command.  Should not be directly used by individuals.
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.                                    - END -
  1604.  
  1605.  
  1606.                                     NOTES:
  1607.                                     ~~~~~~
  1608.                                     
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.                                     
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.                                     NOTES:
  1666.                                     ~~~~~~
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.